home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / ASSEMBLE / H538.ZIP / SIM68.DOC < prev   
Text File  |  1991-08-03  |  7KB  |  218 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.           Introduction
  8.                                         SIM68
  9.                    Version 2.20
  10.  
  11.       Welcome  to the latest release of SIM68,  the  Motorola  MC68HC11
  12.       simulator  designed    to    allow  the    product  engineer  and
  13.       programmer to run and  debug  68HC11 .S19 object code  on  a  IBM
  14.       PC, or equivalent.
  15.  
  16.       SIM68  allows you to load and actually watch your object code run
  17.       in  a manner  similar to the format of the BUFFALO  monitor,  but
  18.       with a  full screen display on an IBM compatible PC.
  19.  
  20.       Below is a list of some of the SIM68 programming features:
  21.  
  22.       - Set and alter program breakpoints
  23.  
  24.       - Enable a full time display of memory location contents  during
  25.         program execution (single bytes)
  26.  
  27.       - Enable the display of 32 bytes of contiguous memory, ie useful
  28.         for examining buffers and caches
  29.  
  30.       - A CPU cycle stop watch which allows you  to  perform  actual
  31.         CPU cycle timing of program loops
  32.  
  33.       - A memory mapping feature displaying the actual block of  memory
  34.         that code has been loaded into
  35.  
  36.       - A feature that allows the modification of register and  memory
  37.         location contents
  38.  
  39.       - Full support of all 68HC11 Op Codes, for a non-test mode system
  40.  
  41.       - The  ability to run a user defined assembler and  editor  from
  42.         within SIM68
  43.  
  44.       - The ability to simulate all of the MC68HC11 interrupts at  any
  45.         point during program's execution
  46.  
  47.       - SIM68 now displays source code instead of disassembled object
  48.         code.  This feature is based on the presence of an AS11
  49.         (Motorola's freeware Assembler) list file ie.
  50.  
  51.             AS11 test.asm -l > test.lst
  52.  
  53.       - The ability to display and modify memory contents  dynamically
  54.         during program execution
  55.  
  56.       - EEPROM programming and emulation
  57.  
  58.       - Improved  run time simulation speed,  ie faster screen updates
  59.         and code interpretation
  60.  
  61.       - Logging of simulator session to disk or printer
  62.  
  63.       - Support of timer and PACC interrupts (new)
  64.  
  65.       - Use of full context sensitive help screens (new)
  66.  
  67.  
  68.       - The ability to save and restore previous SIM68 sessions
  69.  
  70.       Disclaimer
  71.  
  72.       No warranties of any kind are expressed or implied by  myself  or
  73.       this product.   I assume no responsibility for any damages caused
  74.       as a result of using this package.  I hereby commit SIM68 version
  75.       2.20 into the public domain,  for use in private  and  commercial
  76.       engineering environments.
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.       The Future
  85.  
  86.       The  SIM68  simulator  package  will continue to grow and evolve,
  87.       gaining the  ability   to  emulate  more  of  the  true  internal
  88.       functions  of  the Motorola 68HC11 and other mirco-controllers.
  89.  
  90.       The    SIM68   package is written in the C  programming  language
  91.       (using Borland's  Turbo-C++ compiler)  and    assembler.      The
  92.       source  code  is available  for  sale.   I  must stress that this
  93.       is   an  ever  growing software   product  that  will  eventually
  94.       be a commercially  offered  product.
  95.  
  96.       If  you  have any problems or suggestions please write to  me  at
  97.       the following address:
  98.  
  99.              Perry J. Fisch
  100.              24 Barellan Avenue
  101.              Carlingford, NSW  2018
  102.              Australia
  103.  
  104.              or
  105.  
  106.              Perry J. Fisch
  107.              1553 Sugarwood Circle
  108.              Winter Park, FL  32792
  109.              USA
  110.  
  111.       The Catch...
  112.  
  113.       A fee of $35.00 (Australian) $25.00 (US), paid via check made
  114.       payable to Perry Fisch and mailed to either of the above addresses,
  115.       will enable you to receive complete program documentation, help
  116.       sub-system, I/O and A/D options and place you on a mailing list so
  117.       that we can notify you of future program upgrades.
  118.  
  119.       Please understand, you now have a fully functional SIM68 68HC11
  120.       program simulator, however, there are more than 100 key combinations
  121.       and other options which are fully desribed in the documentation.
  122.       You can do productive work without the documentation, but the
  123.       printed docs will make life a little easier for you...
  124.  
  125.       The 34,000+ lines of SIM68 source code are available for
  126.  
  127.         $275.00 Australian and $200 US.
  128.  
  129.       If you like how SIM68 works,  and find it useful I  suggest  that
  130.       you  register.    I am sorry that I must ask for money,  however,
  131.       this simple project that I started a while ago has turned into  a
  132.       monster, consuming vast amounts of my time.
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.       System Requirements
  142.  
  143.       The  current  SIM68  package (Version 2.20) requires a minimum of
  144.       512Kb or memory,  monochrome or color monitor,  and  an  optional
  145.       printer.   Note: an EGA or VGA monitor is required to support the
  146.       I/O and A/D simulator modules.
  147.  
  148.       As  stated above the 512 Kb of memory is what SIM68 needs to load
  149.       and operate,   any additional memory will be used to support  the
  150.       external editor and assembler.
  151.  
  152.  
  153.  
  154.       Help Sub-system
  155.  
  156.       This release (the release you now have) is shipped with an
  157.       incomplete help system.  The registered package will have the full
  158.       300+ pages of 'on-line' SIM68 help and 'advise'.
  159.  
  160.  
  161.       I/O Device Simulator
  162.  
  163.       This release also comes with a demo of the SIM68 I/O and A/D state
  164.       simulators.  The registered package will have the full working
  165.       modules.
  166.  
  167.  
  168.       Installing SIM68
  169.  
  170.       To install the MC68HC11 simulator please run the setup program by
  171.       typing:
  172.  
  173.         setup-68.exe <cr>
  174.  
  175.       note: <cr> means carriage return or enter
  176.  
  177.       The setup package will allow you to specify the source and
  178.       destination drives and directories and will ensure that the progam
  179.       is installed correctly.
  180.  
  181.  
  182.       Running SIM68
  183.  
  184.       After typing sim68 at the DOS prompt you will be presented with a
  185.       menu of six choices:
  186.  
  187.             1) Run SIM68
  188.             2) Change Working Directory
  189.             3) Run User Defined Editor
  190.             4) Run User Defined Assembler
  191.             5) Configure SIM68
  192.             6) Exit to DOS
  193.  
  194.       Note  this is not a literal list of options,  but I hope it helps
  195.       convey the meaning of the options.
  196.  
  197.       Option 1 is obviously the work horse of the system, this is where
  198.       the user S19 code is actually run.   After  the  simulator  loads
  199.       your  S19  file  into it's memory you will see the working screen
  200.       with a display of register contents and a  comment  window.    At
  201.       this  point  hit  the  F1  key  and  the package will give a good
  202.       overview of all of it's abilities. (sample help screen)
  203.  
  204.       From  this  point  forward you are  on  your  own.    I'm  in  the
  205.       middle   of version 2.3 and a Windows 3.0 based MC68332 simulator
  206.       and I've got a lot of work to do,  not to mention the  fact that I
  207.       wrote SIM68 to be a tool  not a  product, and I've  got   alot  of
  208.       work  to  do  on my 68HC11 systems.
  209.  
  210.       Good luck,  and I  hope  this proves useful you.   Please  let me
  211.       know if  you have any problems with the package, I really do want
  212.       to   make this a useful product,  not to mention make a few bucks
  213.       too!
  214.  
  215.  
  216.       Perry Fisch
  217.  
  218.